home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / sdk / man / cat3 / strtok.0 < prev    next >
Encoding:
Text File  |  1998-06-15  |  2.1 KB  |  45 lines
  1.  
  2. STRTOK(3)                  UNIX Programmer's Manual                  STRTOK(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttookk, ssttrrsseepp - string token operations
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttrriinngg..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ssttrrttookk(_c_h_a_r _*_s_t_r, _c_o_n_s_t _c_h_a_r _*_s_e_p)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ssttrrsseepp((33))..
  15.  
  16.      The ssttrrttookk() function is used to isolate sequential tokens in a null-ter-
  17.      minated string, _s_t_r. These tokens are separated in the string by at least
  18.      one of the characters in _s_e_p. The first time that ssttrrttookk() is called, _s_t_r
  19.      should be specified; subsequent calls, wishing to obtain further tokens
  20.      from the same string, should pass a null pointer instead.  The separator
  21.      string, _s_e_p, must be supplied each time, and may change between calls.
  22.  
  23.      The ssttrrttookk() function returns a pointer to the beginning of each subse-
  24.      quent token in the string, after replacing the separator character itself
  25.      with a NUL character.  When no more tokens remain, a null pointer is re-
  26.      turned.
  27.  
  28. SSEEEE AALLSSOO
  29.      index(3),  memchr(3),  rindex(3),  strchr(3),  strcspn(3),  strpbrk(3),
  30.      strrchr(3),  strsep(3),  strspn(3),  strstr(3)
  31.  
  32. SSTTAANNDDAARRDDSS
  33.      The ssttrrttookk() function conforms to ANSI C3.159-1989 (``ANSI C'').
  34.  
  35. BBUUGGSS
  36.      There is no way to get tokens from multiple strings simultaneously.
  37.  
  38.      The System V ssttrrttookk(), if handed a string containing only delimiter char-
  39.      acters, will not alter the next starting point, so that a call to
  40.      ssttrrttookk() with a different (or empty) delimiter string may return a non-
  41.      NULL value.  Since this implementation always alters the next starting
  42.      point, such a sequence of calls would always return NULL.
  43.  
  44. 3rd Berkeley Distribution        June 29, 1991                               1
  45.